home *** CD-ROM | disk | FTP | other *** search
/ Network PC / Network PC.iso / amiga utilities / applications / database / superviewel / superviewlibrary / docs / svsupport-docs / superviewsupport.doc < prev   
Encoding:
Text File  |  1997-11-20  |  5.7 KB  |  176 lines
  1.  
  2.   superviewsupport.library
  3.  
  4.   © 1994-96 by Andreas R. Kleinert.
  5.  
  6.   FREEWARE. All rights reserved.
  7.  
  8.   Version      : 6.12
  9.   Release Date : 29.02.1996
  10.  
  11.  
  12.   Description
  13.   ~~~~~~~~~~~
  14.   superviewsupport.library contains functions, which are heavily used
  15.   by the superview.library and its SVObjects, SVDrivers and SVOperators.
  16.  
  17.   superviewsupport.library helps saving diskspace by just holding this
  18.   functions for usage by the other libraries.
  19.  
  20.  
  21.   There are also functions, which just might be useful for testing
  22.   and debugging new modules or programs using superview.library.
  23.  
  24.  
  25.   superviewsupport.library is mostly independent of the other Libraries yet.
  26.   Nevertheless some of the functions also depend on other Libraries,
  27.   like e.g. SVSUP_DisplayGfxBuffer(), which does SVDriver calls.
  28.  
  29.  
  30.   Author
  31.   ~~~~~~
  32.   Andreas R. Kleinert
  33.   Sandstrasse 1
  34.   D-57072 Siegen            Andreas_Kleinert@t-online.de
  35.   Germany                   Andreas_Kleinert@superview.ftn.sub.org
  36.  
  37.  
  38.   ControlPad-Switches
  39.   ~~~~~~~~~~~~~~~~~~~
  40.   ControlPad-Name     : "ENV:superview-library/superviewsupport.controlpad"
  41.   ControlPad-Commands : - C2P=<OS|SV>
  42.                           ; determines, whether chunky to planar conversion
  43.                           ; is managed via the appropriate OS functions
  44.                           ; or via internal ones.
  45.                           ; Due to various problems with the OS functions
  46.                           ; "SV" is now default.
  47.                           ; Be careful when using "OS" with GfxCards,
  48.                           ; which carelessly patched graphics.library.
  49.  
  50.   History
  51.   ~~~~~~~
  52.   V6.12 (29.02.1996) :
  53.  
  54.    - ScreenToOnePlane() still had bugs (same as early ECS, AGA svdrivers,
  55.      but just for reading instead of writing). Fixed alignment, using
  56.      separate buffer now. Also removed some redundancies and usage
  57.      of UWORDs (now possibly faster on 680x0 machines, x>1).
  58.      Fixes saving directly from Screens.
  59.      (-> Simon Edwards)
  60.    - BestModeID() now never returns INVALID_ID anymore. Never.
  61.    - added new snail+email adress to this doc
  62.  
  63.   V6.11 (19.12.1995) :
  64.  
  65.    - now does no longer drop comments and linefeeds when loading/saving
  66.      (-> Steve Quartly)
  67.      See includes and docs for more information.
  68.  
  69.   V6.10 (29.10.1995) :
  70.  
  71.    - recompiled with SAS/C V6.56
  72.  
  73.   V6.9 (29.7.1995) :
  74.  
  75.    - as long as either PAL or NTSC is available, SVSUP_GetBestModeID()
  76.      will no longer produce IDs using DEFAULT_MONITOR (mask 0x0000FFFF).
  77.      Should help promoting PAL/NTSC to >31KHz.
  78.  
  79.   V6.8 (5.6.1995) :
  80.  
  81.    - using "C2P=OS" should again be saver now (no guarantee)
  82.    - source buffer (copy) for c2p conversion now better aligned
  83.      (was not aligned, 16 was required, now is 32 Bit aligned ;-)
  84.    - removed old "cut off last upto 7 pixels" restriction.
  85.      Seems to work now properly.
  86.    - V39: aligned width of temporary BitMap to 32, although should
  87.           be done by AllocBitMap(). Safer this way, if routines are patched.
  88.  
  89.   V6.7 (18.5.1995) :
  90.  
  91.    - new C2P routines had been buggy for "less than 256 color graphics"
  92.  
  93.   V6.6 (14.5.1995) :
  94.  
  95.    - wrote replacement for OS-dependent "chunky to planar" routines,
  96.      which is now default due to the bugs/problems of the former ones
  97.    - some functions did not handle A1 safely
  98.  
  99.   V6.5 (6.5.1995) :
  100.  
  101.    - slightly revised memory routines
  102.  
  103.   V6.4 (30.4.1995) :
  104.  
  105.    - fully recompiled with SAS/C V6.55
  106.    - now saves A1 when opened/closed
  107.    - prepared to safely handle conversion of GfxBuffers > V2
  108.      (same problem, which would have caused several obsolete versions
  109.       to produce garbage on copying V2 buffers).
  110.      Will cut the version down to the lowest supported now.
  111.  
  112.   V6.3 (4.2.1995) :
  113.  
  114.    - fixed behaviour on library open errors when initializing
  115.  
  116.   V6.2 (25.1.1995) :
  117.  
  118.    - there was a bug in the ControlPad functions for modifying and
  119.      adding: if an entry already existed it might have been allocated
  120.      less memory than needed for the new entry (1 Byte).
  121.      This caused an Enforcer-Hit claiming that 16 Bytes had been trashed.
  122.      Usually would have crashed the system.
  123.  
  124.   V6.1 (13.11.1994) :
  125.  
  126.    - added seven new functions for VIRTUAL MEMORY handling
  127.  
  128.   V5.1 (29.10.1994) :
  129.  
  130.    - added three new functions for ControlPad support,
  131.      as e.g. SVSUP_ModifyControlPad()  (-> Steve Quartly)
  132.  
  133.   V4.3 (28.09.1994) :
  134.  
  135.    - WritePixelLine8() sometimes seems to destroy the source buffer.
  136.      Fixed now by using a copy of the corresponding line content.
  137.  
  138.   V4.2 (05.09.1994) :
  139.  
  140.    - created a workaround for the same "chunky pixel" bug as this has been
  141.      done with the SVDriver-Release of superview.library 8.2
  142.      (sooner or later guru'ed, if width had not been on byte boundary)
  143.  
  144.   V4.1 (26.06.1994) :
  145.  
  146.    - added two new functions for temporary displaying of GfxBuffers
  147.      (e.g. for test-purposes) and one function for free'ing "stand-alone"
  148.      GfxBuffers, which are not related to a SVObject-Handle.
  149.    - fixed some bugs in the documentation, concerning the return values
  150.      of the OnePlane/BitPlane-functions (not boolean, but SVERR_)
  151.      and of SVSUP_AllocMemEntry()
  152.  
  153.   V3.1 (27.05.1994) :
  154.  
  155.    - added two new functions for converting ONEPLANE SV_GfxBuffers into
  156.      BITPLANE SV_GfxBuffers and vice versa. Works with upto 8 Bit.
  157.      (see SVSupport_Reference.doc)
  158.    - added two new functions for converting Screens into ONEPLANE or
  159.      BITPLANE SV_GfxBuffers. Works with upto 8 Bit.
  160.      (see SVSupport_Reference.doc)
  161.  
  162.   V2.1 (22.05.1994) :
  163.  
  164.    - added four new functions for handling new, standardized "ControlPads"
  165.      (see SVSupport_Reference.doc and ControlPad.doc)
  166.  
  167.   V1.1 (07.05.1994) :
  168.  
  169.    - first version with 13 functions yet (see SVSupport_Reference.doc)
  170.  
  171.  
  172.   Copyrights
  173.   ~~~~~~~~~~
  174.   Some of the mentioned names or products above may be copyrighted by
  175.   companies or trademarks of companies.
  176.